HTML - What is a Web API?
एक वेब एपीआई एक डेवलपर का सपना है।
- यह ब्राउज़र की कार्यक्षमता का विस्तार करेगा
- यह जटिल संचालन को बहुत सरल बनाता है
- यह जटिल कोड के लिए सरल वाक्यविन्यास प्रदान करेगा
वेब एपीआई क्या है?
एपीआई (API) एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस (Application Programming Interface) के लिए है। API एक प्रकार का इंटरफ़ेस है जिसमें फ़ंक्शंस और पदार्थों का एक सेट शामिल होता है जो डेवलपर्स को किसी एप्लिकेशन, ऑपरेटिंग सिस्टम या अन्य सेवाओं की विशिष्ट सुविधाओं या डेटा तक पहुँचने की अनुमति देता है।
एक वेब एपीआई वेब के लिए एक एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस है।
एपीआई की भूमिका:
एपीआई "मध्यवर्ती" होते हैं जो विभिन्न सॉफ्टवेयर घटकों को एक - दूसरे के साथ संवाद करने की अनुमति देते हैं। वे डेवलपर्स को एप्लिकेशन के आंतरिक कामकाज को उजागर किए बिना इसके कार्यों का उपयोग करने की अनुमति देते हैं।
एचटीएमएल एपीआई
सभी ब्राउज़रों में जटिल संचालन का समर्थन करने और डेटा तक पहुंचने में मदद करने के लिए अंतर्निहित वेब एपीआई का एक सेट होता है।
यहाँ कुछ प्रमुख HTML5 API दिए गए हैं:
1. जियोलोकेशन एपीआई
इस API का इस्तेमाल यूज़र की मौजूदा लोकेशन (अक्षांश और देशांतर के साथ) को ऐक्सेस करने के लिए किया जाता है।
2. ड्रैग एंड ड्रॉप एपीआई
यह API आपको ब्राउज़र में ड्रैग - एंड - ड्रॉप सुविधाओं का उपयोग करने में सक्षम करेगा।
3. वेब स्टोरेज एपीआई
इस API में एल्गोरिदम हैं जो ब्राउज़र को कुंजी/मान जोड़े (कुकीज़ की तुलना में अधिक सहज तरीके से) संग्रहीत करने की अनुमति देते हैं।
4. वेब वर्कर्स एपीआई
यह API किसी जावास्क्रिप्ट पेज को उसके प्रदर्शन को प्रभावित किए बिना बैकग्राउंड में चलाने की अनुमति देता है। जब वेब वर्कर बैकग्राउंड में चलता है, तो यूज़र कुछ भी कर सकते हैं: क्लिक करना, चीज़ें चुनना वगैरह।
5. सर्वर - भेजे गए इवेंट एपीआई
यह API वेब पेज को सर्वर से स्वचालित रूप से अपडेट प्राप्त करने की अनुमति देता है।
6. Canvas API
यह API आपको जावास्क्रिप्ट के साथ तुरंत ग्राफ़िक्स बनाने की अनुमति देता है।
HTML एपीआई का उपयोग करने पर नोट्स
HTML API लागू करते समय, आपको हमेशा:
ब्राउज़र की क्षमता की पुष्टि करें
हमेशा जाँच लें कि टार्गेट ब्राउज़र API को सपोर्ट करते हैं। अगर कोई ब्राउज़र इसे सपोर्ट नहीं करता है, तो हमेशा एक स्क्रिप्ट या मैसेज जोड़ें।
// ब्राउज़र समर्थन की जाँच करें यदि (नेविगेटर.जियोलोकेशन) { // एपीआई समर्थित है }अन्यथा{ // एपीआई समर्थित नहीं है चेतावनी ("आपका ब्राउज़र जियोलोकेशन एपीआई का समर्थन नहीं करता"); }मजबूत गड़बड़ी हैंडलिंग जोड़ें
ऐसी स्थितियों का निरीक्षण करने के लिए, जहाँ एपीआई (API) उम्मीद के मुताबिक काम नहीं कर रहा है, गड़बड़ी से निपटने के लिए मज़बूत तरीके जोड़ें, जिससे उपयोगकर्ता को सहज अनुभव मिल सके।
यूज़र की अनुमति का अनुरोध करें
संवेदनशील डेटा को एक्सेस करने वाले API का उपयोग करते समय, जैसे कि जियोलोकेशन API (जो उपयोगकर्ता की भौगोलिक स्थिति को एक्सेस करता है), आगे बढ़ने से पहले हमेशा उपयोगकर्ता की सहमति मांगें।
तृतीय पक्ष एपीआई
थर्ड - पार्टी API आपके ब्राउज़र में बिल्ट - इन नहीं हैं।
इन API का इस्तेमाल करने के लिए, आपको वेबसाइट से कोड डाउनलोड करना होगा।
YouTube API
इससे आप किसी वेबसाइट पर वीडियो दिखा सकते हैं।
video.play() video.pause()Twitter API
आपको किसी वेबसाइट पर ट्वीट्स दिखाने की अनुमति देता है।
tweet.load() tweet.embed()Facebook API
इससे आप किसी वेबसाइट पर Facebook की जानकारी प्रदर्शित कर सकते हैं।
FB.login() FB.api()तृतीय पक्ष एपीआई कुंजियाँ:
ज़्यादातर थर्ड - पार्टी API को आपके ऐप्लिकेशन को ऑथेंटिकेट करने के लिए API की ज़रूरत होती है। ये चाबियाँ आमतौर पर API प्रदाता की वेबसाइट पर मुफ़्त में उपलब्ध होती हैं।
एपीआई उपयोग उदाहरण
जियोलोकेशन एपीआई का उदाहरण
<!DOCTYPE html> <एचटीएमएल> <सिर> <शीर्षक>जियोलोकेशन उदाहरण - जैसिफ टीम</शीर्षक> </head> <शरीर> <h1>जियोलोकेशन एपीआई उदाहरण</h1> <बटन ऑनक्लिक='गेटलोकेशन()'>मेरा स्थान प्राप्त करें</बटन> <p id='डेमो'></p> <स्क्रिप्ट> फ़ंक्शन getLocation() { // 1. ब्राउज़र समर्थन की जाँच करें यदि (नेविगेटर.जियोलोकेशन) { // 2. उपयोगकर्ता की अनुमति का अनुरोध करें navigator.geolocation.getCurrentPosition(showPosition, showError); }अन्यथा{ // 3. त्रुटि प्रबंधन document.getElementById("डेमो").innerHTML = "आपका ब्राउज़र जियोलोकेशन एपीआई का समर्थन नहीं करता है।"; } } फ़ंक्शन शोपोज़िशन(स्थिति) { // एपीआई ने सफलतापूर्वक प्रतिक्रिया दी document.getElementById("डेमो").innerHTML = "अक्षांश:" + स्थिति.निर्देशांक.अक्षांश + "<br>देशांतर: " + स्थिति.निर्देश.देशांतर; } फ़ंक्शन शोत्रुटि(त्रुटि) { // 4. मजबूत त्रुटि प्रबंधन स्विच(त्रुटि.कोड) { केस त्रुटि.PERMISSION_DENIED: document.getElementById("डेमो").innerHTML = "उपयोगकर्ता ने स्थान की अनुमति से इनकार कर दिया।"; तोड़ना; केस त्रुटि.POSITION_UNAVAILABLE: document.getElementById("डेमो").innerHTML = "स्थान की जानकारी उपलब्ध नहीं है"; तोड़ना; केस त्रुटि.समय समाप्त: document.getElementById("डेमो").innerHTML = "स्थान अनुरोध का समय समाप्त हो गया"; तोड़ना; केस त्रुटि.UNKNOWN_ERROR: document.getElementById("डेमो").innerHTML = "एक अज्ञात त्रुटि उत्पन्न हुई"; तोड़ना; } } </स्क्रिप्ट> </body> </html>